SparkN0de-git - /page/blob.mu

Micron Document

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

| SparkN0de-git | SparkN0de |

Node / ReticulumProjects / MeshChatX.git / files / lang / README.zh.md

Displaying Rendered • View raw • Download

lang/README.zh.md v4.4.0-rc.3 (0115fa43) Text, 9.91 KB

Reticulum MeshChatX

English README | Deutsch | Italiano | Русский | 日本語

Liam Cottle 开发的 Reticulum MeshChat 的一个功能丰富的深度修改分支。

本项目独立于原始 Reticulum MeshChat 项目，与其无关联。

• 网站: meshchatx.com

• 源码: git.quad4.io/RNS-Things/MeshChatX

• 官方镜像: github.com/Sudo-Ivan/MeshChatX — 目前亦用于 Windows 与 macOS 构建。

• 发行版: git.quad4.io/RNS-Things/MeshChatX/releases

• 变更日志: CHANGELOG.md

• TODO: Boards

与 Reticulum MeshChat 的重要差异

• 使用 LXST

• 以原生 SQL 替代 Peewee ORM

• 以原生 T383838fetch 替代 Axios

• 使用最新 Electron

• T383838.whl 内置 Web 服务器与前端资源，便于多种部署方式

• i18n

• 使用 PNPM 与 Poetry 管理依赖

│ [!WARNING] MeshChatX 不保证与旧版 Reticulum MeshChat 的数据兼容。迁移或测试前请备份数据。

│ [!WARNING] 旧系统尚未完全支持。当前最低要求：Python T383838>=3.11，Node T383838>=24。

系统要求

• Python T383838>=3.11（来自 T383838pyproject.toml）

• Node.js T383838>=24（来自 T383838package.json）

• pnpm T38383810.32.1（来自 T383838package.json）

• Poetry（用于 T383838Taskfile.yml 与 CI 工作流）

T282828

task install

task lint:all

task test:all

task build:all

安装方式

请按运行环境与打包形式选择。

┌─────────────────────┬──────────┬──────────────────────────┬─────────────────────────────────────┐

│ 方式 │ 包含前端 │ 架构 │ 适用场景 │

├─────────────────────┼──────────┼──────────────────────────┼─────────────────────────────────────┤

│ Docker 镜像 │ 是 │ T383838linux/amd64, T383838linux/arm64 │ Linux 服务器快速部署 │

│ Python wheel (T383838.whl) │ 是 │ 任何 Python 支持的架构 │ 无需 Node 构建的无头/Web 服务器安装 │

│ Linux AppImage │ 是 │ T383838x64, T383838arm64 │ 便携式桌面使用 │

│ Debian 包 (T383838.deb) │ 是 │ T383838x64, T383838arm64 │ Debian/Ubuntu 安装 │

│ RPM 包 (T383838.rpm) │ 是 │ 取决于 CI │ Fedora/RHEL/openSUSE │

│ 从源码 │ 本地构建 │ 主机架构 │ 开发与自定义构建 │

└─────────────────────┴──────────┴──────────────────────────┴─────────────────────────────────────┘

说明:

• 发布工作流明确构建 Linux T383838x64 与 T383838arm64 的 AppImage + DEB。

• RPM 亦会尝试构建，成功时上传。

快速开始: Docker

T282828

docker compose up -d

默认 compose 文件映射:

• 主机 T383838127.0.0.1:8000 -> 容器端口 T3838388000

• T383838./meshchat-config -> T383838/config 持久化

如遇权限问题:

T282828

sudo chown -R T79c0ff1000:1000 ./meshchat-config

从发行版安装

1) Linux AppImage (x64/arm64)

1. 从发行版下载 T383838ReticulumMeshChatX-v<版本>-linux-<架构>.AppImage。

2. 赋予执行权限并运行:

T282828

chmod +x ./ReticulumMeshChatX-v*-linux-*.AppImage

./ReticulumMeshChatX-v*-linux-*.AppImage

2) Debian/Ubuntu T383838.deb (x64/arm64)

1. 下载 T383838ReticulumMeshChatX-v<版本>-linux-<架构>.deb。

2. 安装:

T282828

sudo apt install ./ReticulumMeshChatX-v*-linux-*.deb

3) RPM 系统

1. 若发行版中存在，下载 T383838ReticulumMeshChatX-v<版本>-linux-<架构>.rpm。

2. 安装:

T282828

sudo rpm -Uvh ./ReticulumMeshChatX-v*-linux-*.rpm

4) Python wheel (T383838.whl)

发行版 wheel 包含已构建的前端资源。

T282828

pip install ./reticulum_meshchatx-*-py3-none-any.whl

meshchatx --headless

亦支持 T383838pipx:

T282828

pipx install ./reticulum_meshchatx-*-py3-none-any.whl

从源码运行（Web 服务器模式）

在开发或需要本地定制构建时使用。

T282828

git clone https://git.quad4.io/RNS-Things/MeshChatX.git

Tffa657cd MeshChatX

corepack Tffa657enable

pnpm install

pip install poetry

poetry install

pnpm run build-frontend

poetry run python -m meshchatx.meshchat --headless --host T79c0ff127.0.0.1

在沙盒中运行（Linux）

若要在额外隔离文件系统的情况下运行原生 T383838meshchatx（别名：T383838meshchat），可使用 Firejail 或 Bubblewrap（T383838bwrap），同时保留 Reticulum 与 Web 界面所需的网络访问。完整示例（pip/pipx、Poetry、USB 串口说明）见:

• docs/meshchatx_linux_sandbox.md

在提供已捆绑或已同步的 T383838meshchatx-docs 时，应用内文档（MeshChatX 文档）列表亦会显示同一页面。

从源码构建桌面包

脚本定义于 T383838package.json 与 T383838Taskfile.yml。

Linux x64 AppImage + DEB

T282828

pnpm run dist:linux-x64

Linux arm64 AppImage + DEB

T282828

pnpm run dist:linux-arm64

RPM

T282828

pnpm run dist:rpm

或通过 Task:

T282828

task dist:fe:rpm

架构支持

• Docker: T383838amd64, T383838arm64

• Linux AppImage: T383838x64, T383838arm64

• Linux DEB: T383838x64, T383838arm64

• Windows: T383838x64, T383838arm64（提供构建脚本）

• macOS: 提供构建脚本（T383838arm64、T383838universal），适用于本地构建环境

• Android: 仓库内含项目与 CI 工作流

Android

• docs/meshchatx_on_android_with_termux.md

• android/README.md

配置

┌────────────────────────┬──────────────────────────────────────┬───────────┬──────────────────────┐

│ 参数 │ 环境变量 │ 默认值 │ 说明 │

├────────────────────────┼──────────────────────────────────────┼───────────┼──────────────────────┤

│ T383838--host │ T383838MESHCHAT_HOST │ T383838127.0.0.1 │ Web 服务器绑定地址 │

│ T383838--port │ T383838MESHCHAT_PORT │ T3838388000 │ Web 服务器端口 │

│ T383838--no-https │ T383838MESHCHAT_NO_HTTPS │ T383838false │ 禁用 HTTPS │

│ T383838--ssl-cert / T383838--ssl-key │ T383838MESHCHAT_SSL_CERT / T383838MESHCHAT_SSL_KEY │ （无） │ PEM 证书与私钥路径… │

│ T383838--rns-log-level │ T383838MESHCHAT_RNS_LOG_LEVEL │ （无） │ Reticulum（RNS）日… │

│ T383838--headless │ T383838MESHCHAT_HEADLESS │ T383838false │ 不自动打开浏览器 │

│ T383838--auth │ T383838MESHCHAT_AUTH │ T383838false │ 启用基本认证 │

│ T383838--storage-dir │ T383838MESHCHAT_STORAGE_DIR │ T383838./storage │ 数据目录 │

│ T383838--public-dir │ T383838MESHCHAT_PUBLIC_DIR │ 自动/捆绑 │ 前端文件目录（无捆… │

└────────────────────────┴──────────────────────────────────────┴───────────┴──────────────────────┘

分支

┌────────┬──────────────────────────────────────────┐

│ 分支 │ 用途 │

├────────┼──────────────────────────────────────────┤

│ T383838master │ 稳定发布。仅限生产就绪代码。 │

│ T383838dev │ 活跃开发。可能包含不稳定或不完整的更改。 │

└────────┴──────────────────────────────────────────┘

开发

T383838Taskfile.yml 中的常用任务:

T282828

task install

task lint:all

task test:all

task build:all

T383838Makefile 快捷方式:

┌──────────────┬─────────────────────────────┐

│ 命令 │ 说明 │

├──────────────┼─────────────────────────────┤

│ T383838make install │ 安装 pnpm 与 poetry 依赖 │

│ T383838make run │ 通过 poetry 运行 MeshChatX │

│ T383838make build │ 构建前端 │

│ T383838make lint │ 运行 eslint 与 ruff │

│ T383838make test │ 运行前端与后端测试 │

│ T383838make clean │ 移除构建产物与 node_modules │

└──────────────┴─────────────────────────────┘

版本

本仓库当前版本: T3838384.4.0。

• JavaScript/Electron 版本以 T383838package.json 为准。

• T383838meshchatx/src/version.py 通过以下命令与 T383838package.json 同步:

T282828

pnpm run version:sync

发布时请保持相关字段一致（T383838package.json、T383838pyproject.toml、T383838meshchatx/__init__.py）。

安全

• SECURITY.md

• 应用内置完整性检查与默认 HTTPS/WSS

• T383838.gitea/workflows/ 中的 CI 扫描工作流

添加语言

语言由目录自动发现。添加新语言只需一个 JSON 文件:

1. 从 T383838en.json 生成空白模板:

T282828

python scripts/generate_locale_template.py

将写入 T383838locales.json，所有键值为空字符串。

2. 重命名并移入语言目录:

T282828

mv locales.json meshchatx/src/frontend/locales/xx.json

3. 在文件顶部设置 T383838_languageName 为该语言的母语名称（例如 T383838"Espanol"、T383838"Francais"）。将显示在语言选择器中。

4. 翻译其余全部值。

5. 校验键一致性: T383838pnpm test -- tests/frontend/i18n.test.js --run

无需其他代码更改。应用、语言选择与测试在构建时从 T383838meshchatx/src/frontend/locales/ 发现语言文件。

致谢

• Liam Cottle - 原始 Reticulum MeshChat

• RFnexus - Micron 解析器（JavaScript）

• markqvist - Reticulum, LXMF, LXST

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────